/*
 * Copyright 2017-2020 吴学文 and java110 team.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.java110.fee.cmd.feeSub;

import com.alibaba.fastjson.JSONObject;
import com.java110.core.annotation.Java110Cmd;
import com.java110.core.context.ICmdDataFlowContext;
import com.java110.core.event.cmd.Cmd;
import com.java110.core.event.cmd.CmdEvent;
import com.java110.dto.payFee.PayFeeSubDto;
import com.java110.intf.fee.IPayFeeSubV1InnerServiceSMO;
import com.java110.utils.exception.CmdException;
import com.java110.utils.util.Assert;
import com.java110.utils.util.BeanConvertUtil;
import com.java110.vo.ResultVo;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;

import java.util.ArrayList;
import java.util.List;


/**
 * 类表述：查询
 * 服务编码：payFeeSub.listPayFeeSub
 * 请求路劲：/app/payFeeSub.ListPayFeeSub
 * add by 吴学文 at 2024-01-05 12:10:47 mail: 928255095@qq.com
 * open source address: https://gitee.com/wuxw7/MicroCommunity
 * 官网：http://www.homecommunity.cn
 * 温馨提示：如果您对此文件进行修改 请不要删除原有作者及注释信息，请补充您的 修改的原因以及联系邮箱如下
 * // modify by 张三 at 2021-09-12 第10行在某种场景下存在某种bug 需要修复，注释10至20行 加入 20行至30行
 */

/**
 * 费用子项管理查询命令类
 * 
 * 该类用于处理费用子项的分页查询请求，主要功能包括：
 * 1. 验证请求参数和分页信息
 * 2. 验证管理员权限
 * 3. 查询费用子项数据并返回分页结果
 * 
 * @author 吴学文
 * @version 1.0
 * @since 2024-01-05
 */
@Java110Cmd(serviceCode = "feeSub.listAdminPayFeeSub")
public class ListAdminPayFeeSubCmd extends Cmd {

    private static Logger logger = LoggerFactory.getLogger(ListAdminPayFeeSubCmd.class);
    
    /**
     * 费用子项服务接口，用于调用费用子项相关的业务方法
     */
    @Autowired
    private IPayFeeSubV1InnerServiceSMO payFeeSubV1InnerServiceSMOImpl;

    /**
     * 请求参数验证方法
     * 
     * 该方法用于验证请求参数的合法性，包括：
     * 1. 验证分页参数是否正确
     * 2. 验证当前用户是否具有管理员权限
     * 
     * @param event 命令事件对象，包含请求相关信息
     * @param cmdDataFlowContext 命令数据流上下文，用于获取和设置请求响应数据
     * @param reqJson 请求参数的JSON对象
     */
    @Override
    public void validate(CmdEvent event, ICmdDataFlowContext cmdDataFlowContext, JSONObject reqJson) {
        // 验证分页参数，确保分页信息完整有效
        super.validatePageInfo(reqJson);
        // 验证管理员权限，确保当前用户具有管理员操作权限
        super.validateAdmin(cmdDataFlowContext);
    }

    /**
     * 执行费用子项查询命令
     * 
     * 该方法主要执行以下操作：
     * 1. 将请求参数转换为费用子项数据传输对象
     * 2. 查询费用子项总数
     * 3. 根据分页参数查询费用子项列表
     * 4. 构建分页响应结果并设置到响应实体中
     * 
     * @param event 命令事件对象
     * @param cmdDataFlowContext 命令数据流上下文
     * @param reqJson 请求参数的JSON对象
     * @throws CmdException 当命令执行过程中发生错误时抛出
     */
    @Override
    public void doCmd(CmdEvent event, ICmdDataFlowContext cmdDataFlowContext, JSONObject reqJson) throws CmdException {
        // 将请求JSON参数转换为PayFeeSubDto对象，便于后续查询操作
        PayFeeSubDto payFeeSubDto = BeanConvertUtil.covertBean(reqJson, PayFeeSubDto.class);

        // 查询符合条件的费用子项总数，用于分页计算
        int count = payFeeSubV1InnerServiceSMOImpl.queryPayFeeSubsCount(payFeeSubDto);

        List<PayFeeSubDto> payFeeSubDtos = null;

        // 根据查询结果数量决定返回的数据列表
        if (count > 0) {
            // 如果存在数据，则查询具体的费用子项列表
            payFeeSubDtos = payFeeSubV1InnerServiceSMOImpl.queryPayFeeSubs(payFeeSubDto);
        } else {
            // 如果没有数据，返回空列表避免null值
            payFeeSubDtos = new ArrayList<>();
        }

        // 计算总页数：总记录数除以每页显示行数，向上取整
        int totalPage = (int) Math.ceil((double) count / (double) reqJson.getInteger("row"));
        // 构建包含分页信息的返回结果对象
        ResultVo resultVo = new ResultVo(totalPage, count, payFeeSubDtos);

        // 创建HTTP响应实体，设置响应状态为200 OK
        ResponseEntity<String> responseEntity = new ResponseEntity<String>(resultVo.toString(), HttpStatus.OK);

        // 将响应实体设置到数据流上下文中，完成请求处理
        cmdDataFlowContext.setResponseEntity(responseEntity);
    }
}